---
title: Réiteach fadhbanna
description: San rannán seo mínítear conas fadhbanna a réiteach le Ultracite.
---

Cé gur cuireann Ultracite an lintáil agus an formáidiú i gcóir níos simplí, d’fhéadfadh roinnt fadhbanna a bheith agat nó ceisteanna a bheith ann le linn an tsocraithe agus an úsáide. Seo roinnt fadhbanna coitianta agus a réitigh:

## “Ultracite isn’t formatting on save in VS Code.”

Déan cinnte go bhfuil an síneadh Biome do VS Code suiteáilte agus cumasaithe. Seiceáil go bhfuil i do `.vscode/settings.json` na ionchuir `"editor.defaultFormatter": "biomejs.biome"` agus `"editor.codeActionsOnSave"` mar a léirítear i [Socrú](/setup).

Chomh maith leis sin, déan cinnte nach bhfuil síneadh formáidithe nó lintála eile ag teacht i bhfeidhm (m.sh., má tá an síneadh Prettier nó an síneadh ESLint fós gníomhach, d’fhéadfadh siad cur isteach nó tosaíocht a ghlacadh).

B'fhéidir go mbeidh ort an rogha thógtha isteach i VS Code *Format On Save* a dhíchumasú má tá formáidí eile ag iarraidh an comhad a láimhseáil. Má tá na socruithe ceart agus an síneadh Biome gníomhach, ba cheart do chomhad a shábháil a chlúdaíonn Ultracite (js/ts/jsx/tsx/json/css) formáidiú a spreagadh. Mura dtarlaíonn sé sin, bain triail as an ordú “Format Document” a rith de láimh agus féach an n-úsáidtear Biome nó an bhfeictear aon earráid.

## “I installed Ultracite, but VS Code still uses ESLint or Prettier.”

Déan cinnte gur bhain tú na sean-chumruithe sin nó gur chuir tú iad as. Mar shampla, má tá `.eslintrc` nó `.prettierrc` sa tionscadal, d’fhéadfadh síneadh ESLint VS Code a bheith gníomhach fós agus diagnóis dhúblach a chruthú.

Moltar na cumruithe sin a bhaint (nó ar a laghad na síneadh a dhíchumasú) nuair a bhíonn tú ag athrú go Ultracite chun mearbhall a sheachaint. Go bunúsach, lig do Ultracite/Biome a bheith mar an t-aon linter/formattóir.

Má roghnaíonn tú ESLint a choinneáil ar chúis éigin, ná cumasaigh “fix on save” don ESLint – ina dhiaidh sin d’fhéadfadh an bheirt iarracht a dhéanamh an cód a shocrú (cé má tá siad cumraithe i gceart, ba chóir do Biome teacht le stíl Prettier chun coimhlint a sheachaint).

Go ginearálta, má aistríonn tú go hiomlán chuig Ultracite ní gá duit cumruithe ESLint / Prettier a choinneáil níos mó.

## “Ultracite (Biome) is throwing parse errors for files I don’t want it to check.”

Sampla maith de seo ná le comhpháirteanna a shuiteáil ó leabharlann UI cosúil le [`shadcn/ui`](https://ui.shadcn.com/). Cé go bhfuil siad deartha le bheith inrochtana le hathruithe, b’fhéidir gur mhaith leat an cód foinse bunaidh a chaomhnú le haghaidh nuashonruithe. Sa chás seo, ba mhaith leat lintáil a dhíchumasú don chineál sin comhad.

Chun é sin a dhéanamh, cuir patrúin eisceachta isteach i do `biome.jsonc`, mar shampla:

```json title="biome.jsonc"
{
  "files": {
    "includes": [
      "**/*",
      "!components/ui",
      "!lib",
      "!hooks",
    ]
  },
}
```

De ghnáth, ba cheart do Biome `node_modules` a scipeáil, ach má d’oscail tú comhad ón áit sin de láimh, d’fhéadfadh an síneadh iarracht a dhéanamh é a lintáil fós. De ghnáth, scip comhaid ghiniúna troma nó cód ó thríú páirtí — níl gá duit iad sin a lintáil.

Fachtóir eile is féidir a bheith ann ná má tá sintéis turgnamhach i gcomhad nach féidir le Biome a pharsáil (m.sh., togra stage-3 nach bhfuil i mbun Biome fós). Sa chás sin, seachain an sintéis sin nó féach an féidir Biome a chumrú (uaireanta trí `"parser.allowSomething": true` a chur sa chumraíocht má tá an rogha sin ar fáil).

Seiceáil rian earráidí Biome le haghaidh tacaíochta don tsintéis sin.

## “I see double errors for the same issue.”

Is féidir seo a tharlú má tá roinnt linters ag rith ag an am céanna (mar shampla, ESLint agus Ultracite araon). Is féidir é a tharlú freisin má tá seiceáilrán TypeScript VS Code agus Biome ag tuairisciú an earráid TS chéanna. Chun réiteach, caith seirbhís amháin a bheith i bhfeidhm in aghaidh gach cineál seiceáil.

Má tá tú ag úsáid Ultracite, díchumasaigh linters eile. Maidir le hearráidí cineálacha TypeScript, taispeánfaidh freastalaí TS tógtha i VS Code iad (m.sh., línte dearga do shaincheisteanna cineálacha) – is féidir le Biome freisin earráidí lint a tharraingt a bhaineann le cineálacha. De ghnáth níl fadhb leis agus iad ag leagan béime ar an bhfadhb chéanna. Ach má mheabhraíonn sé duit, is féidir leat feidhmchláir tástála TS VS Code a dhíchumasú (`"typescript.validate.enable": false` i socruithe) agus brath ar Biome, nó an bealach eile a dhéanamh.

I bhformáidí is mó, tá sé ceart go leor iad beirt a fhágáil ar siúl; go minic comhfhreagraíonn siad lena chéile (earráidí cineálacha vs earráidí lint). Déan cinnte nach bhfuil beirt linters agat a bhfuil feidhmeanna thar a chéile acu (cosúil le ESLint agus Biome ag déanamh lintála araon).

## “Pre-commit hook/CI is failing due to Ultracite.”

Má rithtear do pre-commit hook `ultracite` agus go bhfuil sé ag teip, ciallaíonn sé go bhfuil fadhbanna ann nach ndearna an uirlis auto-fix orthu (nó gur scipeadh é ag duine éigin). An bealach is fearr chun é a shocrú ná `npx ultracite` a rith go háitiúil agus an t-aschur a iniúchadh. Nó réiteoidh sé cuid acu (sa chás sin, staitgh saor na hathruithe agus déan coimisiún arís) nó tuairiscíonn sé earráidí a éilíonn socrú láimhe.

Déan na socruithe sin, ansin déan an coimisiún. Má tá CI ag teip ar `ultracite --check`, déan amhlaidh: rith é go háitiúil le `--check` chun a fheiceáil cad a fuair sé, nó rith é gan `--check` chun a n-auto-fix a dhéanamh agus ansin coimisiún a dhéanamh na torthaí. I mbeagán focal, córaisigh teipeanna Ultracite amhail a bheadh tástálacha teipthe — rud le ceartú sa chód.

## “I get an error about `strictNullChecks` or type issues after enabling Ultracite.”

Tá Ultracite ag súil le dianghnéithe TypeScript. Mura ndearna tú `strictNullChecks` (nó an *full strict*) a chumasú, d’fhéadfadh go bhfaighidh tú go leor rabhaidh a bhaineann le TypeScript (mar shampla, gearán faoi úsáid fhéideartha gan a bheith sainmhínithe nach bhfuil TS ag gabháil air de bharr socruithe réidh).

An réiteach is fearr ná na bratacha dian sin a chumasú i do `tsconfig` mar a mholtar. Má tá cúiseanna le linn na hoidhreachta nach féidir leat iad a chumasú, b’fhéidir go mbeidh ort roinnt rialacha in Ultracite a mhúchadh a ghlacann leis an ndianmhéid. Ach mholtar go láidir dul isteach i mód dian TS — feabhsaíonn sé sin cáilíocht do chód agus tá sé i gcoinne pholasaithe Ultracite.

## “Ultracite is too strict for our team (too many rules) – can I tone it down?”

Sea. Cé go bhfuil buntáiste Ultracite i ndianrú, tá tú saor rialacha a shaincheapadh. Má tá forbróirí faoi bhois an ghutha ó thaobh rabhaidh, aithin cé na rialacha atá ina gcúis le frithchuimilt. B’fhéidir gur rogha stíle nó rud nár cheart don chomhthéacs. Is féidir na rialacha sin a chur go `warn` nó `off` sa chumraíocht.

Mar shampla, má aimsíonn tú go bhfuil na rialacha inacmhainne maidir le rochtain do uirlis inmheánach, d’fhéadfá cuid acu a dhíchumasú. Nó má aontaíonn tú nach bhfuil stíl cód áirithe inmholta, is féidir í a choigeartú (cé go bhfuil sé mar chuspóir ag Ultracite easpa díospóireachta maidir le stíleanna).

An rud is tábhachtaí ná cumarsáid leis an bhfoireann — b’fhéidir míniú cén fáth go bhfuil rialachán ann sula gcuirtear iad as; má tá siad fós míchompordach, déan an chumraíocht a shaincheapadh. Ní bosca dorcha é Ultracite — tá lán smachta agat tríd an `biome.jsonc`.

Féach an rannán [cumraíocht](/configuration) le haghaidh tuilleadh eolais ar conas rialacha a shárú.

## “Are there known limitations or bugs with Ultracite I should be aware of?”

Ní chlúdaíonn Ultracite (Biome go sonrach) gach rud a chlúdaíonn ESLint + Prettier + Stylelint, go háirithe más úsáideann tú breiseáin áirithe. Mar shampla, bhí Stylelint le tacar iomlán rialacha lint CSS; soláthraíonn Biome faoi láthair formáidiú do CSS agus lint bhunúsach, ach ní an tacar iomlán rialacha Stylelint.

Má tá do thionscadal ag brath ar sheiceálacha Stylelint ar leith (cosúil le ordú airíonna nó ainmniú áirithe i CSS), tabhair faoi deara nach n-iarraíonn Ultracite iad. D’fhéadfá Stylelint a chur leis ar leithligh más gá i ndáiríre, nó fanacht agus féachaint an dtiocfaidh tuilleadh lintáil CSS ó Biome le himeacht ama.

---

Má théann tú i dtaithí ar fhadhb nach mbaineann leis an áit atá seo clúdaithe, smaoinigh ar leathanach na n-ábhar i GitHub Ultracite nó ar dhoiciméadú Biome a sheiceáil. B’fhéidir go bhfuil socrú nó réiteach sealadach ar fáil. Tá an pobal ag fás, mar sin tá an tacaíocht ag feabhsú le himeacht ama.